package com.qianying.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.qianying.comment.CommonResult;
import com.qianying.entity.PlatformTimeliness;

/**
 * 平台时效表Service接口
 * 包含增删改查及分页查询功能
 *
 * @author check
 * @date 2025-08-02
 */
public interface PlatformTimelinessService extends IService<PlatformTimeliness> {

    /**
     * 分页查询平台时效列表
     * @param page 分页参数
     * @param timelinessType 时效类型（可选，模糊查询）
     * @return 分页结果
     */
    CommonResult<IPage<PlatformTimeliness>> getPage(Page<PlatformTimeliness> page, String timelinessType);

    /**
     * 根据ID查询平台时效
     * @param id 主键ID
     * @return 单条结果
     */
    CommonResult<PlatformTimeliness> getById(Long id);

    /**
     * 新增平台时效（含字段校验）
     * @param timeliness 平台时效实体
     * @return 新增结果
     */
    CommonResult<?> saveTimeliness(PlatformTimeliness timeliness);

    /**
     * 更新平台时效（含字段校验）
     * @param timeliness 平台时效实体（含ID）
     * @return 更新结果
     */
    CommonResult<?> updateTimeliness(PlatformTimeliness timeliness);

    /**
     * 根据ID删除平台时效
     * @param id 主键ID
     * @return 删除结果
     */
    CommonResult<?> removeById(Long id);
}